home *** CD-ROM | disk | FTP | other *** search
/ Netware Super Library / Netware Super Library.iso / ipx_netx / ptf235 / read.me < prev    next >
Text File  |  1991-01-11  |  12KB  |  236 lines
  1.                               S N A   N O T E
  2.  
  3. PTF 235 TBMI Windows DOS Compatibility Box for NetWare 3270 Workstation
  4.  
  5. APPLIES TO: NetWare 3270 LAN Workstation 
  6.           Not to be used with 3270 LAN Workstation for Windows which will begin
  7.           shipment in the Spring 
  8.  
  9. SUPERSEDES: PTF227 which contains a corrupted JUMP.EXE
  10.  
  11. DATE: January 11, 1991
  12.    
  13. PTF 235 is a temporary work around prior to the release of the NetWare 3270
  14. LAN Workstation for Windows, which will be a true Windows application. 
  15.  
  16. PTF 235 is a limited solution, it has far less functionality than will be
  17. contained within NetWare 3270 LAN Workstation for Windows.  In addition,
  18. you must understand that PTF 235 is only provided as a convenience to you
  19. and is definitely not guaranteed to work in all environments.  If you
  20. encounter problems which appear to be workstation related, you must
  21. reproduce the problem in a non-Windows environment prior to calling
  22. Technical Support.     
  23.  
  24. TBMI (Task switched Buffer Manager for IPX/SPX) and IPX.OBJ v3.02 correct
  25. problems running an application that makes direct calls to IPX or SPX
  26. (called a peer-to-peer application) under NetWare within a DOS box in a
  27. multitasking environment such as Microsoft Windows.  With TBMI and TASKID
  28. loaded, you should be able to switch away from a running peer-to-peer
  29. application (such as 3270 LAN Workstation).    
  30.  
  31. INSTALLATION
  32. 1. See "LIMITATIONS" below
  33.  
  34. 2. Generate IPX.COM from the v3.02 IPX.OBJ.
  35.  
  36. 3. Remove VIPX.386 from the NETWORK=statement in the SYSTEM.INI Windows
  37. file. 
  38.  
  39. 4. Because Windows 3.0 uses some of the same key sequences as the NetWare
  40. 3270 LAN Workstation, you will need to redefine <Alt><SysRq> and <Alt><Esc>
  41. (if configured for host printing).  These key sequences can be redefined in
  42. either the DEFAULT.PIF file for the DOS session in Windows or by using the
  43. KEYDEF utility for the NetWare 3270 LAN Workstation. 
  44.  
  45. 5. (OPTIONAL)  Create one or more configuration files. 
  46. TBMI reads configuration information from a configuration file in the
  47. current directory.  Enter one parameter on each line in the configuration
  48. file.  The file's name is NET.CFG by default; a different name can be
  49. specified using the /C parameter on the command line. (see APPENDIX for
  50. configuration file parameters.  
  51.  
  52. RUNNING
  53. 1. LOAD the new IPX 
  54.  
  55. 2. LOAD NET3 or NET4 (optional)
  56.  
  57. 3. Login to file server (optional)  
  58.  
  59. 4. Enter "TBMI" on the command line, followed by optional command line
  60. parameters listed below. 
  61.           /? or /H                      Display help or usage information. 
  62.           /C <filename>                 Load TBMI using a configuration file. For example enter
  63.                                         "TBMI /C TBMI.CFG" on the command line.  
  64.           /D                  Display diagnostic information and current allocation
  65.                               limits. 
  66.           /I                  Display version information. 
  67.           /U                  Unload TBMI from memory after exiting Windows. 
  68.      
  69. 5. WIN (from Microsoft Windows diskette) 
  70.   
  71. 6. Double click on the DOS icon and load TASKID, followed by WSLAN. 
  72.           > Run NetWare 3270 LAN Workstation in background and full-screen
  73.           modes.  Attempting to run the workstation software in a window may
  74.           cause unpredictable results. 
  75.  
  76. 7. At the new DOS prompt, enter the command "TASKID" followed by optional
  77. command line parameters in each DOS session.  This provides the two way
  78. communication needed for virtualizing asynchronous events in the DOS
  79. session.  TASKID provides a unique ID to TBMI to be used in virtualizing   
  80. IPX and SPX calls.  
  81.           Valid TASKID.COM command line parameters.  
  82.                     /? or /H    Display help or usage information. 
  83.                     /D          Display diagnostic information. 
  84.                     /I          Display version information. 
  85.                     /U          Unload TASKID from memory. 
  86.           We recommend that you unload TASKID from the DOS session's memory
  87.           before closing the session.  Do not unload TASKID before task
  88.           switching.  
  89.  
  90. 8. Repeat step #5 for each DOS session you will be using before loading the
  91. 3270 Workstation.  NOTE: Load WSLAN only once.  If you attempt to load it
  92. more than once on the same workstation the machine will hang. 
  93.  
  94. 9. TO EXIT
  95. Before closing a DOS session with the EXIT command, remember to first type
  96. "TASKID /U" to unload TBMI from that session.  Failure to unload TASKID
  97. from a session's memory before closing the session may result in loss of
  98. data buffers and machine hanging.  It is not necessary to unload TBMI after
  99. exiting Windows, but you may wish to do so to free up memory.  
  100.  
  101. NOTE: The Windows Default for Background is 50 and for Foreground is 100. 
  102. If you experience problems try setting Foreground to a higher number
  103. (perhaps as high as 1,000).
  104. Also double check "limitations".
  105.  
  106.           LIMITATIONS 
  107. 1) You must run in 386 mode. Your machine should have at least 4 Meg of
  108. memory. 
  109. 2) You must use LAN printer redirection for printing from the host session.
  110.  
  111. 3) SNA must use either Definite Response (set in the bind image) or Pacing
  112. (set to a non-zero value in VTAM) if you do not set the window session for
  113. background processing. 
  114.  
  115. 4) Closing the host window task without unloading the workstation software
  116. will cause the host session to hang.  This will prevent you from getting
  117. back into the host session.  Therefore, it is recommended that you run
  118. WSEXIT, followed by TASKID /U, prior to closing the host window. 
  119.  
  120. 5) A limitation of Windows is that it may not reload special fonts when you
  121. switch between workstation sessions. This causes the host status line to
  122. appear corrupted if your host session is configured for Extended Data
  123. Stream.  Simply jumping to DOS, then back to your host session, causes
  124. WSLAN to automatically reload the status line font. 
  125.  
  126. 6) Sometimes Windows needs to be reloaded several times when you have a TSR
  127. in place. If, when you load Windows, you are taken back to the DOS prompt,
  128. simply reload Windows. 
  129.  
  130. 7) The mouse is not supported in a host session. 
  131.  
  132. 8) Vector Graphics is not supported in a host session. 
  133.  
  134. FILES IN THE PTF 
  135. TBMI                COM                 16817               12-19-90   4:34p 
  136. TASKID              COM                 2623                12-19-90   3:48p 
  137. IPX                 OBJ                 19917               12-18-90   9:48a   
  138. JUMP      EXE                 11161               06-07-89  12:38p                          
  139. READ.ME
  140.  
  141. POSSIBLE BATCH FILE 
  142. If you would like to create an icon to execute a batch file to load WSLAN,
  143. the following sequence of commands is recommended: 
  144.     TASKID 
  145.     WSLAN 
  146.     PAUSE 
  147.     JUMP (using JUMP.EXE included with PTF)
  148.     WSEXIT 
  149.     TASKID /U 
  150.     EXIT 
  151.  
  152. This batch file is OPTIONAL and is only useful if you need just a single
  153. host session and do not wish to run Send/Receive or API applications.  This
  154. is because when you jump back to the DOS session, WSLAN must be unloaded in
  155. order to prevent the host session from hanging.  However, this BAT file
  156. illustrates the options available to customize the Windows environment.
  157.  
  158. DISCUSSION
  159. The Windows environment in real and standard modes allows application
  160. switching (sometimes called swapping).  Each application runs in a separate
  161. DOS session in 640K of memory.  Part of this memory (global memory)
  162. contains drivers and TSRs such as COMMAND.COM, IPX.COM and NETx.COM.  The
  163. other part of memory, (local memory) contains the application and
  164. application data.   
  165. Windows switches from one DOS application to another by moving the contents
  166. of the current DOS session from conventional memory to extended memory (if
  167. present) or to disk, and then loading the contents of the new DOS session
  168. into conventional memory. Only the local memory is switched; the global
  169. memory with its drivers and TSRs stays intact and is used with the new
  170. session. This means that separate local memory segments exist, one for each
  171. DOS session, while only one global memory segment exists.  
  172.  
  173. When an IPX accessing application,such as the 3270 LAN Workstation (in
  174. local memory) wants to communicate with the network, it makes a call
  175. directly to IPX or SPX (in global memory), bypassing the shell.  IPX or SPX
  176. then passes the call on to the network.  If the application is then
  177. switched, IPX or SPX will lose contact with the application, being unable
  178. to use the program's data.  
  179.  
  180. With TBMI, the application (in local memory) calls IPX, but the call is
  181. intercepted by TBMI (in global memory), which passes the call to IPX or SPX
  182. and then to the network. TBMI maintains a buffer in global memory to hold
  183. calls received from the various local segments, and then remaps this buffer
  184. to the various sessions as they are switched. TBMI (in global memory) also
  185. receives ID information from TASKID (a copy of which is stored in each
  186. local memory) so that it knows which session it is receiving calls from.
  187. Without TBMI the application cannot be switched without failing. 
  188.  
  189. There is no need for TBMI in DOS sessions if you will not be switching
  190. between sessions.  If you are not sure if there will be task switching go
  191. ahead and run TBMI; it will not affect operations in any way other than use
  192. a small amount of memory.
  193.  
  194.                                                                        APPENDIX
  195. The following are valid configuration file parameters: 
  196. INT 64              
  197. This is similar to the IPX configuration parameter; it specifies that TBMI
  198. should support interrupt 64h IPX and SPX calls. This should be set to
  199. either OFF or ON. For example, enter the line "INT 64 = ON" in the
  200. configuration file.  The default is ON for maximum compatibility.  
  201.  
  202. INT 7A    
  203. This is similar to the IPX configuration parameter; it specifies that TBMI
  204. should support interrupt 7Ah IPX and SPX calls. This should be set to
  205. either OFF or ON.  For example, enter the line "INT 7A = ON" in the
  206. configuration file. The default is ON for maximum compatibility.  
  207.  
  208. ECB COUNT                     
  209. This specifies how many nondata event control blocks (ECBs) will be
  210. allocated for use by DOS programs needing virtualization.  These ECBs apply
  211. to most AES events. If TBMI runs out of nondata ECBs, data ECBs can be
  212. allocated for use. If no ECB can be allocated from TBMI's pool of ECBs, a
  213. failure will result with a completion code of FEh (or -2). The minimum
  214. allowed value for this parameter is 10, the maximum is 255, and the default
  215. is 20. For example, enter the line "ECB COUNT = 20" in the configuration
  216. file. Each allocated ECB requires 52 bytes of memory; the 20 ECB default
  217. will require 1040 bytes. The maximum allocation also depends upon available
  218. memory, and the total size of all ECBs must be less than 64K, which will
  219. normally limit the ECB count to less than 255. Use the /D command line
  220. parameter to verify actual allocations.  
  221.  
  222. DATA ECB COUNT                          
  223. Specifies how many data ECBs will be allocated for use by DOS programs
  224. needing virtualization. These ECBs apply to most IPX and SPX send-and-
  225. receive packets. If a nondata ECB request is made when none are available,
  226. a data ECB will be used. If no ECBs are available from TBMI's pool of ECBs,
  227. a failure will result with a completion code of FEh (or -2).  
  228.                                         
  229. The minimum allowed value for this parameter is 10, the maximum is 255, and
  230. the default is 60. For example, enter the line "DATA ECB COUNT = 60" in the
  231. configuration file. 
  232. Each allocated data ECB requires 628 bytes of memory; the 60 ECB default
  233. will require 37680 bytes.  The maximum allocation also depends upon
  234. available memory, and the total size of all ECBs must be less than 64K,
  235. which will normally limit the data ECB count to less than 255. Use the /D
  236. command line parameter to verify actual allocations.